12.4 取得代收匯率(商家自訂匯 率)
#簡單描述: 取得代收商戶自訂匯率介面(商家自訂匯率)
- 要求方式: POST
- 請求介面: https://网关域名/wallet-trade-merchant/v1/utils/rate/receive/merchant
- 請求媒體類型( JSON 資料格式 )Content-Type: application/json
查詢參數
| 參數名稱 | 類型 | 必填 | 參數意義 | 參數說明 |
|---|---|---|---|---|
key | string | 是 | 商家 key | apiKey |
currency | string | 是 | 幣種(訂單幣種) | 範例:CNY |
userCurrency | string | 是 | 用戶實收幣種 | 範例:USDT |
sign | string | 是 | md5 簽章 | 詳情請見簽章演算法(文件2) |
請求json範例
{
"key": "9yUreYgTRtit39Dy",
"currency": "CNY",
"userCurrency": "USDT",
"sign":"dbc72adf640a82e0b21f98c50afb2881"
}
傳回值
| 參數名稱 | 類型 | 參數意義 | 參數說明 |
|---|---|---|---|
code | int | 請求狀態 | 通訊狀態 成功回傳:0,其它表示失敗 |
success | boolean | 成功狀態 | true 成功 |
message | string | 說明 | |
data | json | 參數 | 參數詳見下列說明 |
返回範例
{
"code": 0,
"success": true,
"message": null,
"data": {
"baseCurrency": "USDT",
"quoteCurrency": "CNY",
"tradePair": "USDT/CNY",
"rate": 6.37,
"costRate": 6.37,
"costReverseRate": 0.15698587127158556,
"exchangeAction": "SELL",
"quoteExpression": "1USDT≈6.37CNY",
"baseAmount": "15.698587",
"quoteAmount": "100"
}
}
data參數說明
| 參數名稱 | 類型 | 參數意義 | 參數說明 |
|---|---|---|---|
baseCurrency | string | 基礎貨幣 | |
quoteCurrency | string | 報價貨幣 | |
tradePair | string | 交易對 | |
rate | string | 售價 | |
costRate | number | 計算價格( FROM x rate = TO ) | |
costReverseRate | number | 反相計算價格( TO x rate = FROM ) | |
exchangeAction | enum | 交易類型 | BUY:買入| SELL: 賣出 |
quoteExpression | string | 匯率表達式 | 以報價記的表達式 |
baseAmount | string | 基本金額 | 範例基礎金額 |
quoteAmount | string | 報價金額 | 範例報價金額 |